. 
. 
: 
‘ . 
. * 
. 
. 
* . 
. 
*. 
. 
oe 
. 
7 . 
. 
: 
Je 
. 
* 
* 
. 
* 
. 
. 
4 4 
bel 
* 
. » 
bd 
. . 
* 
* 
. . 
> 
. 
. 
. 
. nd . 
. 
® 


. 


* 
; 


PHAR LAP 
SAOIUB 
THITY GUIDE 


* 


3861 LIB 
Utility Guide 


Phar Lap Software, Inc. 

60 Aberdeen Avenue, Cambridge, MA. 02138 
(617) 661-1510, FAX (617) 876-2972 
dox@pharlap.com 
tech-support@pharlap.com 


Copyright 1986-91 by Phar Lap Software, Inc. 


All rights reserved. Printed in the United States of America. No part of this 
publication may be reproduced, stored in a retrieval system, or transmitted in any 
form or by any means, without the prior written permission of Phar Lap Software, 
Inc. Use, duplication, or disclosure by the Government is subject to restrictions as set 
forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer 
Software clause at 252.227-7013. 


First edition: February 1987. 
Second edition: January 1991. 


Phar Lap® is a registered trademark of Phar Lap Software, Inc. 

IBM@® is a registered trademark of IBM Corp. 

Intel® is a registered trademark of Intel Corp. 

386™is a trademark of Intel Corp. 

Microsoft®, MS®, and MS-DOS@® are registered trademarks of Microsoft Corp. 
DEC®, VAX®, and VMS are registered trademarks of Digital Equipment Corp. 
UNIX" is a trademark of Bell Laboratories. 


Table of Contents 


Preface Vii 
Chapter 1 Using 3861 LIB 1 
11 Introduction 1 
i2 Command Line Syntax 1 
13 Indirect Command Files 2 
1.4 3861 LIB Environment Variable 3 
15 Command Line Switches a 


1.5.1 Object Module Switches 

13.2 Map File Switches 

55.3 Library Backup File Switches 
1.5.4 Library Page Size Switch 
1535 Case Sensitivity Switches 


1.6 Order of Librarian Operations ie 
i? Module Naming Conventions 12 
1.8 Library Map Description 13 
19 Converting Intel OMF-86 Libraries 14 
Appendix A 386! LIB Command Line Switches 15 
Appendix B 3861 LIB Error Messages 17 
B.1 Warning Errors 18 
B.2 Severe Errors 19 
B.3 Fatal Errors 21 


Preface 


This manual, 3861 LIB Utility Guide, is for people who intend to create and 
include object library files with an application program. This manual 
presumes a familiarity with the development process and various Phar 
Lap programs, including 386! LINK and LinkLoc. For books and manuals 
with that information, please see the Related Documentation and Books 
section at the end of this preface. 


This manual has one chapter, Using 386! LIB, which documents the 
command line operands and two appendices, 386! LIB Command Line 
Switches and 3861 LIB Error Messages. 


If, after you have read this book, you find that you have suggestions, 
improvements or comments that can make this a better manual, please 
call us, write us or send us mail at: 


Phar Lap Software, Inc. 

60 Aberdeen Avenue, Cambridge, MA. 02138 
(617) 661-1510, FAX (617) 876-2972 
dox@pharlap.com 
tech-support@pharlap.com 
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Manual Conventions 


This manual relies on certain conventions to convey certain types of 
information. On the following pages, these are the conventions: 


courier indicates the items on the command line. 


italics indicate the items on the command line that must have a 
user-entered name or value in place of the items in italics. 


(] square brackets indicate that one or more of the enclosed 
items may be chosen. It is valid not to choose any of the 
items in square brackets. 


ellipsis indicates an item or items that may be repeatedly 
entered. 


Related Documentation and Books 


Intel Corporation. The Concrete Representation of 80286 Module Formats. 
Phar Lap Software, Inc., 3861 LINK Reference Manual. 


we LT aedae 
4 


This manual is printed on acid-free, recycled paper. 
“se Ra 0 m 


This manual was produced on a Macintosh IIcx, using MS-Word. The examples 
illustrated in this manual were developed with 386 | LIB, version 3.0. 
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Chapter 1 


Using 3861 LIB 


1.1 Introduction 


386 | LIB is a librarian for OMF-86 and Easy OMF-386 object files. It is a 
member of the 80386 Software Development Series from Phar Lap 
Software, Inc. 386! LIB is used to create, modify, and inspect object library 
files which can be processed by the Phar Lap linkers 386! LINK and 
LinkLoc. Versions of 386! LIB which run on the IBM PC or PC/AT, 
VAX/VMS, and a number of different UNIX systems are available. This 
manual describes how to use 386! LIB. 


1.2 Command Line Syntax 


The command line used to run the librarian is the name of the librarian 
task image (386LIB on IBM PC systems, XLIB386 on other systems), 
followed by a list of file names and switches. The switches are used to 
override the default operation of the librarian. When errors occur during 
processing of a library, an error message is displayed on the screen and 
written to the map file if it exists. 


A file name can be specified on the command line as a complete file name 
(filename.extension) or can be given without an extension, in which case 
3861 LIB supplies a default extension. The librarian assumes the following 
file name extensions when none are specified: 


Using 386ILIB 


Default Extension on Default Extension on 

File Type IBM PC MS-DOS VAX/VMS and UNIX 
object file .OBJ .086 
library file . LIB .L86 
library backup file . BAK . BAK 
library map file .MAP .MAP 
librarian command . LBC . LBC 


file 


In addition, a complete or partial path may be specified with the file name. 
If none is given, the current default device and directory are assumed. 


Switches begin with the minus sign character (-) followed by the name of 
the switch. No spaces are permitted between the minus sign and the 
switch name. Any arguments to the switch must immediately follow the 
switch, with spaces as separators. Adjacent input file and module names 
may be separated by spaces and/or commas. Adjacent switches, or an 
adjacent switch and input file or module name, must be separated by 
spaces. Input file names and switches may be placed in any order on the 
command line. Input file and module names may not begin with a 
minus sign character, so that 3861 LIB can distinguish between file names 
and switches. Some example command lines intended to demonstrate 
the different 386! LIB operations are included with the command line 
switch descriptions. 


1.3. Indirect Command Files 


Like all other Phar Lap products, it is possible to place commonly used 
386 | LIB command line parameters in an indirect command file. 3861! LIB 
command line parameters are entered in an indirect file in the same 
manner as they would be entered on the command line. Command line 
parameters in indirect command files can be entered using as many lines 
as necessary. To use an indirect command file, preface the name of the 
file on the command line with an at sign (@) character. When 3861 LIB 
encounters a command line parameter which begins with an @ character, 
it will open the file and process the commands in it immediately. If the 
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file name does not have an extension specified, a default of .LBC is used. 
For example, the command 


386LIB @comfile -add newmod 


would cause the command line parameters in the file named 
COMFILE.LBC to be processed before the “-add newmod” parameters. 


1.4 386|1LIB Environment Variable 


The environment variable 386LIB contains a string of one or more 
command switches. This variable is always read by 386! LIB: on MS-DOS 
and UNIX systems, 386! LIB looks in the environment itself; on VMS 
systems, 3861 LIB looks in the logical name table and in the system name 
table. 


Since the environment variable, 386LIB, is scanned before the command 
line is read, the switches specified in the variable can be overridden by 
specifying conflicting switches on the command line. 3861! LIB follows the 
rule that the rightmost (last processed) switch takes precedence. 


The following MS-DOS SET command configures 3861 LIB to process 
user-defined symbols in a case-sensitive manner. 


set 386LIB=-twocase 
1.5 Command Line Switches 


Command line switches are used to change the default operation of 
3861 LIB. By default, 386! LIB will: 


Create an output library which has the same file name as the input library 

Process all symbol names with case insensitivity (upper and lower case versions 
of a symbol being considered identical) 

= Use a library page size of 16 bytes 

* Not create library map or backup files. 


Command line switches begin with a minus sign character (-) followed by 


the name of the switch. There are two forms of each switch name: a long 
form and a short form. Any argument to the switch must immediately 
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follow the switch name, with a space as a separator. If conflicting switches 
are given on the command line, the rightmost (last processed) switch 
takes precedence. 


1.5.1 Object Module Switches 


The object module switches are used to add, delete, and extract object 
modules from libraries. The switches which operate on object modules 
contained in files use the file name which contains the object module as 
an argument. The switches which operate on modules contained in the 
library use the module’s name in the library as an argument. Section 1.7 
describes the module-naming rules employed by 386! LIB. Consult the 
description for a particular switch to see whether it uses file names or 
module names as switch arguments. 


Note: Any of the switches which use object file names as 
arguments will also accept an object library as an 
argument. If an object library is specified as a switch 
argument, each module in the library will be processed as 
appropriate. This feature is useful for merging the 
contents of two library files. 


The -ADD switch is used to add new object modules to an existing object 
library. The modules are specified by the arguments to the -ADD switch. 
If one of the modules being added is already in the library, 386! LIB will 
post an error and the library will not be updated. If the specified library 
does not yet exist, 3861 LIB will post a warning and then create the library 
before adding the specified modules to it. 


Syntax: 
-ADD filename ... 


Short Form: 


-A filename ... 


Example: 


IBM PC/MS-DOS 
3861lib mlib -add newmod 
3861ib mlib -a \obj\nm.obj \newob3j\mod2 \ob3j\mod3 
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VAX/VMS 


x1ib386 mlib -add modl1.o86 
x1ib386 mlib -a DRA1: [obj]modl 


UNIX 
x1ib386 mlib -add new_module 
x1ib386 mlib -a ../obj/modl.o ../newobj/mod2 


The -CREATE switch instructs 386| LIB to create the library from scratch 
using the modules specified by the switch arguments. If the library file 
already exists, the current contents are discarded before creating the new 
library. 


Syntax: 
-CREATE filename ... 


Short Form: 


-C filename ... 


Example: 


IBM PC/MS-DOS 


386lib newlib -create modl.obj mod2.o mod3 
386lib newlib -c \obj\modl \newobj\mod2 \obj\mod3 


VAX/VMS 


x1ib386 newlib -create modl.o86 mod2 mod3 
x1ib386 newlib -c DRA1:[obj]modl [-.newobj]mod2 mod3 


UNIX 


xl1ib386 newlib -create modl.o86 mod2 mod3 
xlib386 newlib -c ../obj/modl ../newobj/mod2 mod3 


The -DELETE switch causes 3861! LIB to remove the specified modules 
from the library being processed. The -DELETE switch uses module 
names as arguments, not file names. This is because the arguments 
reference modules which have already been inserted into a library. 
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If the module or library does not exist, 386! LIB will post an appropriate 
error. 


Syntax: 
-DELETE module ... 


Short Form: 


-D module ... 


Example: 


386lib mathlib -delete trigfunc 
386lib mlib -d sin cos tan 


The -EXTRACT switch causes 3861 LIB to extract a copy of one or more 
object modules from a library. It is followed by a list of module names to 
be extracted. Each module extracted is placed in a file whose name is the 
module name with the default object file extension appended to it. 
Extracting object modules from a library does not alter the original library 
in any way. 


Syntax: 
-EXTRACT module ... 


Short Form: 


-E module ... 


Example: 


386lib mathlib -extract trigfunc 
386lib mlib -e sin cos tan 


The -EXTRACTALL switch causes 386 | LIB to extract a copy of all the object 
modules contained in a library. Its operation is exactly the same as if the - 
EXTRACT switch were specified for each module in the library. Each 
module extracted is placed in a file whose name is the module name with 
the default object file extension appended to it. Like the -EXTRACT 
switch, the -EXTRACTALL switch does not alter the original library in any 
way. 
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Syntax: 
-EXTRACTALL 


Short Form: 
-EALL 


Example: 


386lib mathlib -extractall 
386lib mlib -eall 


The -REPLACE switch is used to replace one or more object modules in an 
existing library. The switch is followed by the names of the files 
containing the object modules to be replaced in the library. If a module 
being replaced is already in the library, 3861 LIB will delete it and then add 
the new object module. If a module is not yet in the library, 386! LIB will 
post a warning and then add the module to the library. If the specified 
library does not yet exist, 386! LIB will post a warning and then create the 
library before adding the specified modules to it. 


Syntax: 
-REPLACE filename ... 


Short Form: 


-R filename ... 


Example: 


IBM PC/MS-DOS 
386lib clib -replace newmod 
386lib hce -r \newobj\mod2 \nobj3\newmod3.o 


VAX/VMS 


x1ib386 mlib -replace [nassist.objrcs]newmod1 .o86 
x1ib386 clibs -r DBA3: [newob}]mod1 


UNIX 


x1ib386 mlib -replace new_module 
xlib386 libm -r ../newobj/modl ../nobj/newmod2.o 
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1.5.2 Map File Switches 


The -MAP switch causes 386| LIB to create a library map file which 
contains a list of all the object modules in the library along with a list of 
all the public symbols defined in each module. The switch is followed by 
the map file name. If the specified map file name does not have an 
extension, 3861 LIB will assign a default of MAP. Section 1.8 of this 
manual contains a description of the library map file format and includes 
some short examples. 


Syntax: 

-MAP filename 
Short Form: 

-M filename 


Example: 


386lib mathlib -map mathlib 
3861ib libc -m libc.1lmp 


The -NOMAP switch causes 3861 LIB to not create a library map for the 
library being processed. This is the default operation of 3861 LIB, and this 
switch is only included for completeness. 
Syntax: 

-NOMAP 
Short Form: 

-NOM 


Example: 


386lib mathlib -extract sin -nomap 
3861lib mlib -delete cos -nom 
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1.5.3 Library Backup File Switches 


The -BACKUP switch causes 386 | LIB to create a backup copy of the library 
before performing an operation which modifies it. The name of the 
backup file is the base name of the library file with the .,BAK extension 
appended to it. 
Syntax: 

-BACKUP 


Short Form: 
-B 
Example: 


386lib libc -replace printf -backup 
386lib mlib -delete cos -b 


The -NOBACKUP switch causes 386| LIB to not create a backup copy of the 
library before performing an operation which modifies it. This is the 
default operation of 3861 LIB; the switch is only included for 
completeness. 


Syntax: 
-NOBACKUP 

Short Form: 
-NOB 

Example: 


386lib libc -replace printf -nobackup 
386lib mlib -delete cos -nob 


1.5.4 Library Page Size Switch 


The -PAGESIZE switch is used to specify the library page size of a library 
file. If the -PAGESIZE switch is not specified, 3861 LIB uses the current 
page size of the library being processed. If the library is being created and 
the -PAGESIZE switch is not specified, 386! LIB assumes a default library 
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page size of 16 bytes. This page size is used when aligning object modules 
in the library, and also limits the maximum size of the library. A bigger 
page size permits a larger maximum library size, but wastes more space 
between the object modules in the library. The -PAGESIZE switch 
parameter must be a power of 2 between 16 and 512 inclusive. The 
maximum library sizes for each of the permissible switch values are: 


Page Size Maximum Library Size 
16 1 Megabyte 
32 2 Megabytes 
64 4 Megabytes 
128 8 Megabytes 
256 16 Megabytes 
512 32 Megabytes 


The library page size parameter is used whenever an operation is 
performed which modifies the library. Thus, it is possible to change the 
page size for an existing library file by using the -PAGESIZE switch while 
performing an operation which modifies the file. 


Syntax: 
-PAGESIZE size 


Short Form: 
-PAGESIZE size 
Example: 
To create a library with a page size of 64 bytes: 


386lib newlib -create modl.obj mod2.0 mod3 -pagesize 64 


To change the page size of a library named “small.lib” to 128 bytes, calling 
the new library “large.lib”: 


386lib large -create small -pagesize 128 
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1.5.5 Case Sensitivity Switches 


By default, 386! LIB is insensitive to the case of user-defined symbols. For 
example, the symbols “my_sym”, “my_SYM”, and “MY_SYM” are all 
considered identical by 386! LIB. A command line switch can be used to 
make 3861 LIB process symbols in a case-sensitive manner. If this option is 
enabled, the three symbols in the above example would all be considered 
different. 


The -ONECASE switch disables case-sensitive processing of user-defined 
symbols. This is the default mode of 3861 LIB; this switch is, therefore, 
redundant but is provided for consistency. 
Syntax: 

-ONECASE 
Short Form: 

-OCc 
Example: 


386lib slibc -replace scanf -onecase 
386lib mlib -add cos -tc 


The -TWOCASE switch enables case sensitive processing of user-defined 
symbols. When this switch is used, upper and lower case versions of the 
same symbol are considered to be different. 
Syntax: 

-TWOCASE 
Short Form: 


~TC 


Example: 


386lib libc -replace printf -twocase 
386lib mlib -add cos -tc 
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1.6 Order of Librarian Operations 


When 3861 LIB is performing multiple operations on a library, it performs 
them in a predetermined order. A user does not usually need to be 
concerned with this order. The order of librarian operations is: 


LZ 


If the object library does not yet exist and it must be created, 386ILIB will 
create it 


Any modules which must be extracted from an existing library are extracted 
before the library is modified 


Any modules which are being deleted or replaced are removed from the library 
The modifications to the library are completed by adding any new modules to 
the library. These modules include any arguments to the -ADD, -CREATE, and - 
REPLACE switches 


Lastly, the library map file is created if the -MAP switch was specified. 


1.7. Module Naming Conventions 


Whenever 3861! LIB adds an object module to a library, it sets the module 
name record in the object module to the base name of the file containing 
the object module. This feature is implemented for compatibility with the 
Microsoft librarian and is useful when a language translator program does 
not generate correct module name information. 


For example, a module contained in the DOS file 


c:\386o0bj\startup. obj 


is added to a library with its module name record set to “startup”, 
independent of the original name the object module had. 


386 | LIB can process object libraries created by other librarians which use 
the same library file format but different module naming conventions. 
When 3861! LIB encounters an object module which does not follow its 
naming conventions, it will extract the base file name from the module 
name record and allow that name to be used with any of the switches 
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requiring a module name. Thus an object module with a module name 
record of 


d: \obj\new\recalc.asm 


would be referenced by using the name “recalc” with any of the switches 
requiring a module name. 


1.8 Library Map Description 


The map file created by the librarian contains a list of the object modules 
in the library, along with a list of the public symbols defined in each 
module. A header at the top of the map identifies the 3861 LIB version 
number and the name of the library being processed. The public symbol 
list for each module is ordered in the same way as the symbols are defined 
in the module. There is no information about the location of each 
routine in its module, as this information is calculated at link time. The 
following example shows the library map file for a small library called 
“test.lib”, which is made up of two object modules called “init.obj” and 
“testmain.obj”: 


386|LIB: 3.0 -- Copyright (C) 1986-90 Phar Lap Software, Inc. 
Library File - test.lib 


Module: init 
_ start 
_exit 


Module: testmain 
_™ain 
_subl 
_recalc 
_redisp 
_makecell 
_delcell 
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1.9 Converting Intel OMF-86 Libraries 


3861 LIB can convert Intel style OMF-86 libraries into Phar Lap style OMF- 
86 libraries for input to 386! LINK or LinkLoc. An example command line 
which performs this conversion follows: 


386LIB pharlap.lib -create intel.lib 
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3861 LIB Command Line 


Switches 


386LIB 


libname filename ... 


@file 


-ADD filename ... 


-BACKUP 


-CREATE filename ... 
-DELETE module ... 


-EXTRACT module ... 


-EXTRACTALL 


-MAP filename 
-NOBACKUP 
—NOMAP 
-ONECASE 


-PAGESIZE number 


-REPLACE filename ... 


-TWOCASE 


Library name [.LIB] 

Open indirect command file 
[.LBC] 

Add new object modules to a 
library 

Make a backup library file 

Create a library from object files 
Delete object modules from a 
library 

Extract object modules from a 
library 

Extract all object modules from a 
library 

Create a library map file [.MAP] 
Do not make a library backup file 
Do not create a library map file 
Case-insensitive symbol 
processing 

Use a library page size of number 
Replace object modules in a 
library 

Case-sensitive symbol processing 


15 


386ILIB Command Line Switches 


This page intentionally left blank. 


16 386ILIB Utility Guide 


Appendix B 


3861 LIB Error Messages 


If an error occurs during library processing, 3861 LIB displays an error 
message on the screen, which identifies the error which occurred along 
with its severity. If the error is associated with a module and/or user- 
defined symbol, the name of the module and/or symbol is displayed as 
well. The same message is also copied to the library map file if a map file 
is created. 


Errors are divided into three categories: warning errors, severe errors, and 
fatal errors. Warning errors are errors which do not compromise the 
integrity of the library and can be ignored if desired; all other specified 
operations will be performed on the library. Severe and fatal errors are 
errors which would result in an invalid library being created. If a severe 
or fatal error occurs, the library file being processed is left unchanged. 


The error message descriptions which follow are organized into sections 


which correspond to the three different categories of errors. The error 
messages are listed in alphabetical order within each of these sections. 
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B.1 Warning Errors 


Warning: 


Cause: 


Solution: 


Warning: 


Cause: 


Solution: 


Warning: 


Cause: 


Solution: 


Library file "XXX" does not exist so it will be 
created 


The librarian was instructed to add object modules to a 
library file that does not exist. When this occurs, 386! LIB 
automatically creates the library and then adds the 
specified modules to it. 


Since this is a warning error, it can be ignored. To avoid 
the warning, use the -CREATE option to create the library 
from the object modules instead. 


Module "XXX" not found -- delete ignored 


An attempt was made to delete a module which is not 
present in the library. 


Check the spelling of the module name against the names 
of the modules in the library. 
Module "XXX" not found -- extract ignored 


An attempt was made to extract a module which is not 
present in the library. 


Check the spelling of the module name against the names 
of the modules in the library. 
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Warning: Module "XXX" not found -- module was added, not 
replaced 
Cause: An attempt was made to replace a module which is not 


present in the library. 


Solution: Since this is a warning error, it can be ignored. Otherwise, 
check the spelling of the module name against the names 
of the modules in the library. 


B.2 Severe Errors 


Error: Because of errors, library file "XXX" has not 
been updated 


Cause: This message is displayed along with other severe errors 
to indicate that the library file being processed was left 
unchanged because the errors would have caused an 
invalid library file to be created. 


Solution: Correct all of the other severe errors signaled by the 
librarian. 
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BEror? 


Cause: 


Solution: 


Error: 


Cause: 


Solution: 
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Cannot create object file for module "XXX" -- 
invalid file name. 


The file name, which 386! LIB would use for a module 
being extracted from a library, is not valid. 3861 LIB creates 
this file name by using the name of the module in the 
library and appending the default object file extension. It 
is possible to cause this error by transferring a library 
between hosts which allow different special characters in 
file names. 


The only solution to this problem is to extract the desired 
module(s) from the library on a host which allows the 
same file names as the host on which the library was 
created. 


Duplicate definition of symbol "XXX" in file 
Ww YYyY" 


A public symbol is defined in more than one object 
module. 


1) Rename the public symbol so that it does not conflict 
with the other public symbol 


2) Delete the public symbol from the module 


3) Do not attempt to put one of the object modules 
defining the symbol in the library. 
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Module "XXX" is already in the library 


An attempt has been made to add an object module to a 
library and another module with the same name is 
already present in the library. 


1) Rename the object file to a different name 
2) Use the -REPLACE switch instead of the -ADD switch to 


delete the old object module from the library before 
adding in the new object module. 


B.3. Fatal Errors 


Fatal Error: 


Cause: 


Solution: 


Fatal Error: 


Cause: 


Solution: 


Bad library file "Xxx" 


The specified library file was not valid. 


Make sure that the specified file conforms to either Phar 
Lap or Microsoft library file format. 


Bad number specified on the command line -- "XXX" 


An invalid number was specified as a command switch 
argument. This error will occur if the number is badly 
formed (illegal numeric characters), or if it is out of range 
for the switch. 


Check the number to make sure it is valid and within the 
permissible range for the switch. 
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Fatal Error: 


Cause: 


Solution: 


Fatal Error: 


Cause: 


Solution: 
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Bad object module in file "XxXx" 


An 3861 LIB operation was attempted with an invalid 
object module. 


1) Make sure that the object module is a valid OMF-86 or 
Easy OMF-386 file 


2) If any errors occurred when compiling or assembling 
the file, correct the errors before attempting to add the 
object file to a library 


3) It is possible to use the Phar Lap linker (386! LINK or 
LinkLoc) to get a more detailed message about what is 
wrong with the object file by linking the file by itself. The 
linker should display the same “invalid object file” 
message, followed by the reason the file is invalid. 


Cannot create "XXX" file -- reason 


3861 LIB was unable to create the file named “XXX” due to 
a host operating system error. The reason for the error is 
displayed at the end of the message and is host dependent. 


Consult the host operating system documentation to 


clarify the meaning of the error and take appropriate 
action to clear it. 
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Fatal Error: Cannot open "XXX" file -- reason 


Cause: 3861 LIB was unable to open the file named “XXX” due to 
a host operating system error. The reason for the error is 
displayed at the end of the message and is host dependent. 


Solution: Consult the host operating system documentation to 
clarify the meaning of the error and take appropriate 
action to clear it. 


Fatal Error: Command too long -- "XxXx" 


Cause: A command line parameter specified in an indirect 
command file is longer than 255 characters. 


Solution: Shorten the parameter which is too long. 
Fatal Error: Error reading from "XXX" file -- reason 
Cause: 3861 LIB was unable to read data from the file named 


“XXX” due to a host operating system error. The reason 
for the error is displayed at the end of the message and is 
host dependent. 


Solution: Consult the host operating system documentation to 


clarify the meaning of the error and take appropriate 
action to clear it. 
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Fatal Error: 


Cause: 


Solution: 


Fatal Error: 


Cause: 


Solution: 


Fatal Error: 


Cause: 


Solution: 
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Error writing to "XXX" file -- reason 


3861 LIB was unable to write data to the file named “XXX” 
due to a host operating system error. The reason for the 
error is displayed at the end of the message and is host 
dependent. 


Consult the host operating system documentation to 
clarify the meaning of the error and take appropriate 
action to clear it. 


Extra command line argument -- "XXX" 


More than one library file was specified on the command 
line, or a switch argument was specified for a switch 
which does not use one. 


Check the command line parameters to eliminate the 
extraneous argument. 

Invalid file name --. "Xxx" 

A file name was specified on the command line which 
does not follow the correct syntax for file names on the 


host computer. 


Use a valid file name. 
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Fatal Error: Library file has overflowed -- increase page size 

Cause: The size of the library file has exceeded 65,536 times the 
library page size. 

Solution: Use the -PAGESIZE switch to specify a larger page size for 


the desired operation. Once the library has been 
successfully updated using the new page size, it is no 
longer necessary to specify the -PAGESIZE switch until the 
file overflows again. 


Fatal Error: Missing value to command switch -- "XxXx" 


Cause: A 386! LIB command switch which requires an argument 
was specified without an argument. 


Solution: Specify a value for the switch. 


Fatal Error: One command file cannot call another command 
file -- “"XXx" 


Cause: An attempt has been made to open an indirect command 
file inside another indirect command file. 3861 LIB does 
not support nesting of indirect command files. 


Solution: 1) Combine the two command files into a single 
command file. 


2) Open the second indirect command file on the 3861 LIB 
command line, rather than inside the first indirect 
command file. 
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386ILIB Error Messages 


Fatal Error: Unknown command switch -- "Xxx" 


Cause: A command switch which was not recognized by 3861! LIB 
was specified on the command line. 


Solution: Check the spelling of the switch name against the list of 
valid 386 | LIB switches. 


26 386ILIB Utility Guide 


@ (at sign) 

in indirect command files, 2 
- (minus sign) 

in switches, 2, 3 


-ADD switch, 4, 15 
at sign (@) 
in indirect command files, 2 


-BACKUP switch, 9, 15 
.BAK file name extension, 2, 9 


a 


case-sensitive processing 
SET command (MS-DOS) for, 3 
switches for, 11 

command line 
case-sensitivity switches on, 11 
fatal error messages for, 21, 23-24 
indirect command files for, 2-3 
library backup file switches on, 9 
library page size switches on, 9-10 
map file switches on, 8 
object module switches on, 4-7 
switches on, 3, 15 
syntax of, 1-2 

commands 
fatal error messages for, 23 


in indirect command files, 2-3 


-~CREATE switch, 5, 15 

D 
defaults, 3 
-DELETE switch, 5-6, 15 

E 


Easy OMF-86 object files, 1 
environment variable, 3 
error messages, 1, 17 

fatal errors, 21-26 

severe errors, 19 

warning errors, 18-19 
extensions 

in file names, 1-2 
-EXTRACTALL switch, 6-7, 15 
-EXTRACT switch, 6, 15 


fatal errors 
messages for, 21-26 
file names 
as arguments to object module switches, 4 
on command line, 1-2 
fatal error messages for, 24 
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Index 


indirect command files, 2-3 
fatal error messages for, 25 
input files 
specified in command line, 2 


L 


.L86 file name extension, 2 
-LBC file name extension, 2 
for indirect command files, 3 
-LIB file name extension, 2 
library backup files 
file name extensions for, 2 
switches for, 9 
library command files, 2 
library files 
-BACKUP switch for, 9 
-CREATE switch for, 5 
-DELETE switch for, 5-6 
-EXTRACTALL switch to extract object modules 
from, 6-7 
-EXTRACT switch to extract object modules 
from, 6 
fatal error messages for, 21, 25 
file name extensions for, 2 
names of object modules in, 12-13 
-NOBACKUP switch for, 9 
order of operations for, 12 
-PAGESIZE switch for, 9-10 
-REPLACE switch for, 7 
severe error messages for, 19, 21 
warning error messages for, 18 
library map files, 13 
error messages written to, 1 
file name extensions for, 2 
-MAP switch for, 8 
-NOMAP switch to not create, 8 
library page size switches, 9-10 
LinkLoc 
OMF-86 library files converted for input to, 14 
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M 


.MAP file name extension, 2, 8 
map files 
see library map files 
map file switches, 8 
-MAP switch, 8, 15 
minus sign (-) 
in switches, 2,3 
modules 
see object modules 
MS-DOS 
environment variable in, 3 
file name extensions in, 2 


N 


names 
see also file names 
for object modules, 4, 12-13 
-NOBACKUP switch, 9, 15 
-NOMAP switch, 8, 15 


O 


.086 file name extension, 2 
object files, 1 
file name extensions for, 2 
names for, 4, 12-13 
object library files, 1 
-ADD switch to add new object modules to, 4 
as arguments to object module switches, 4 
object modules 
-ADD switch to add to object libraries, 4 
-DELETE switch to remove from object libraries, 
5-6 
-EXTRACTALL switch to extract from libraries, 
6-7 
-EXTRACT switch to extract from libraries, 6 
fatal error messages for, 22 
listed in library map files, 13 
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object modules, cont. 
-MAP switch to create library map files of, 8 
naming conventions for, 12-13 
-REPLACE switch for, 7 
severe error messages for, 20 
specified in command line, 2 
warning error messages for, 18-19 
object module switches, 7 
.OBJ file name extension, 2 
OMF-86 library files, 14 
OMF-86 object files, 1 
-ONECASE switch, 11, 15 
operating systems 
file name extensions in, 2 


P 


-PAGESIZE switch, 9-10, 15, 25 
parameters 
in indirect command files, 2-3 
paths 
in command line, 2 
public symbols 
listed in library map files, 13 
-MAP switch to create library map files of, 8 
severe error messages for, 20 


R 


-REPLACE switch, 7, 15 


S 


SET command (MS-DOS), 3 
severe errors 
messages for, 19-21 
switches, 1, 4, 15 
case-sensitivity, 11 
in environment variable, 3 
fatal error messages for, 21, 25, 26 
library backup file, 9 
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Index 


switches, cont. 
library page size, 9-10 
map file, 8 
object module, 7 
syntax of, 2 


386LIB command, 1, 15 
386LIB environment variable, 3 
386 | LINK 
OMF-86 library files converted for input to, 14 
-TWOCASE switch, 11, 15 


U 


UNIX 
environment variable in, 3 
file name extensions in, 2 
user-defined symbols 
case-sensitive processing of, 3 
~ONECASE switch for, 11 
-TWOCASE switch for, 11 


V 
VAX/VMS 


environment variable in, 3 
file name extensions in, 2 


W 


warning errors 
messages for, 18-19 


X386LIB command, 1 
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